Introduction to the CircleCI Web App

When you visit the CircleCI web application you will land on your user homepage.

The user homepage gives your an overview of the organizations of which you are a member, along with options to create a new organization or join an existing organization.

At the top right of the screen you will see notifications and get access to help resources. You can also select your icon to access user settings or to sign out of the app.

At the top left of the screen you will find the CircleCI status badge. The status badge displays the operational health of CircleCI. Select the status badge to enter CircleCI’s status page.

Select an org card and take a look around. The following section describe the various features and options you will find for each organization.

After selecting an organization you will find yourself on the Organization homepage, or Dashboard if you are using CircleCI server. The organization homepage provides an overview of your org’s projects, project health metrics, and compute and credit usage metrics for your org.

From your organization home page you have access to org-level options. You can create a project, select and existing project using the overview project cards, or use the sidebar navigation items to access other areas of the product. The sidebar navigation allows you to visit the following pages (some of these sections are discussed in more detail below):

Pipelines: View all pipelines associated with your organization, You can expand each pipeline to view workflow status, job status, job details, the workflows map, and more. Each pipeline includes controls for cancelling or rerunning workflows, and accessing project settings. Multi-workflow pipelines display a grey bar to the left. You can see the status of each workflow and expand them individually to view the status of each job.

Projects: Allows you to see all projects associated with your organization. Choose to follow or unfollow projects, as well as create/set up new projects.

Deploys: Set up environment integrations to manage deployments for your projects. For full details of the deployments feature, see the Deployment overview page.

Insights: Provides you with time-series data overviews of credit usage, success rates, pipeline duration, and more. For full details of the Insights feature, see the Using Insights page.

Self-Hosted Runners: Set up self-hosted runners to use your own infrastructure for running jobs. Once set up the self-hosted runners dashboard displays a list of your resource classes and self-hosted runners. For full details covering installation, setup, and usage, see the Self-hosted runners overview page.

Organization Settings: Settings for your organization including org roles and groups, contexts, security, orbs and more. You can find your organization ID on this page.

Plan: Displays your network and storage usage, as well as additional settings related to your plan.

The sections below describe some of the pages of the web application in more detail.

Your pipelines appear on the Pipelines dashboard of the CircleCI web app as they are triggered. You can view workflows or single jobs by expanding a pipeline and clicking on any workflow or job descriptor.

When viewing a single job in a pipeline, you can use the breadcrumbs at the top of the page to navigate back to a job’s respective workflow or pipeline.

If you want to change which org you are working within, you have a few options:

If you do not see your project and it is not currently building on CircleCI, check your org in the top left corner of the CircleCI application. For example, if the top left displays your user my-user, only projects belonging to my-user will be available. If you want to add the project your-org/project, you must select your-org from the org switcher.

Projects associated with your organization appear on the Projects page. You have the option to:

Select the ellipsis menu icon in a project row to access project assets, as follows:

The Insights page displays metrics for all projects in your organization over a selected time range (24 hours, seven, 30, 60, and 90 days). The available metrics are as follows:

The Insights page gives you an overview of all projects. You can also select an individual project to get further insights into that project’s workflows. Then you can select individual workflows to see insights on individual jobs and tests.

The self-hosted runners page displays an inventory of your self-hosted runners and their associated resource classes. You can also create a new runner resource class from this page.

Learn more and get started with self-hosted runners on the CircleCI self-hosted runners overview.

The following organization settings are available by selection "Organization Settings" in the sidebar:

If you have administrative privileges, the plan overview and upgrade page displays the features available in your current plan, as well as a snapshot of your usage. Details of the next tier of plan upgrade are also shown. You can read more about plans in CircleCI’s Plan section.

If you are on a paid plan, you can choose to share your plan. This allows any organization you belong to, to share and run builds on your paid-for plan. You can also transfer your plan to another organization.